home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / hdf / unix / examples.lha / examples / ann / README < prev   
Encoding:
Text File  |  1990-09-13  |  2.0 KB  |  64 lines
  1. #ifdef RCSID
  2. static char RcsId[] = "@(#)$Revision: 1.2 $";
  3. #endif
  4. /*
  5. $Header: /pita/work/HDF/dev/RCS/test/annotations/README,v 1.2 90/06/27 11:24:15 mfolk beta $
  6.  
  7. $Log:    README,v $
  8. # Revision 1.2  90/06/27  11:24:15  mfolk
  9. # Revised by Mike Folk.
  10. # 
  11. # Revision 1.1  90/04/19  11:10:52  mfolk
  12. # Initial revision
  13. # 
  14. */
  15.            ******* Annotations routines *******
  16.  
  17.  
  18. This directory contains several program that illustrate the use of 
  19. the HDF annotations interface.  They can also be used to test
  20. the basic functionality of the interface after installing the
  21. HDF library.  
  22.  
  23. Some programs are for testing the HDF object annotation routines.  
  24. Others are for testing HDF file annotation routines.
  25.  
  26. There are C versions of all of the programs.  Corresponding (but
  27. not identical) Fortran programs exist for some of the programs.
  28.  
  29. Programs for testing HDF object annotation interface:
  30.  
  31.    putSDS_RISan <outfile> <height> <width> <reps>:  writes a file
  32.        containingg some number (<reps>) of SDSs and images.  The
  33.        dimensions of the images are all <height>x<width>.
  34.        Two out of every three SDSs are given annotations, but
  35.        all RISs are given annotations.
  36.  
  37.    getSDSan <infile>: prints all of the annotations for all of
  38.        of the SDSs in <infile>.
  39.  
  40.    getSDSlablist <infile>: gets SDS label list for <infile>
  41.    getSDSlablistF:  FORTRAN version.
  42.  
  43.    ann.test: a script to test the above routines.  The results of 
  44.        running ann.test are shown in the file ann.test.result. This
  45.        script works only with the C routines.
  46.  
  47.    get1anF: a test program to get the *second* SDS label and description
  48.        from a file.
  49.  
  50. Programs for testing HDF file annotations:
  51.  
  52.    file_ann_test:  reads and writes several file ids and one file
  53.         description, then reads back all file ids and the first
  54.         file description from the same file.
  55.    file_ann_testF:  FORTRAN version.
  56.  
  57. One ancillary routine is included:
  58.  
  59.     gen2Dfloat contains a program to generate a 2D array of floating
  60.     point numbers for storing in an SDS.  It is called by putSDS_RISan.
  61.  
  62.  
  63.  
  64.